Skip to content

Prepare plugin for OpenAI directory submission - #19

Merged
vystrcild merged 1 commit into
mainfrom
fix/submission-readiness
Sep 8, 2026
Merged

Prepare plugin for OpenAI directory submission#19
vystrcild merged 1 commit into
mainfrom
fix/submission-readiness

Conversation

@vystrcild

Copy link
Copy Markdown
Collaborator

Prep for submitting the plugin to the OpenAI plugin directory (https://developers.openai.com/plugins/deploy/submission). The official validator from the codex repo (plugin-creator/scripts/validate_plugin.py) failed on main with 3 errors and passes after these changes.

Changes

  • .mcp.json: wrap servers in mcpServers. The validator rejects the bare server map (field 'apify' is not accepted). Codex runtime accepts both shapes (PluginMcpFile untagged enum in codex-mcp/src/plugin_config.rs), so no behavior change for existing installs.
  • plugin.json
    • Add interface.defaultPrompt with 3 starter prompts (required by the validator and the submission portal; prompts must not mention the plugin name, max 128 chars).
    • Shorten shortDescription to 30 chars (directory limit). Was 47.
    • Bump version to 1.1.0 to match CHANGELOG (manifest said 0.1.0).
  • README: the hosted MCP server returns 401 on initialize for the plugin's default tool set, so no tool works without signing in. Unauthenticated access only exists when ?tools= is restricted to search-actors, fetch-actor-details, search-apify-docs, fetch-apify-docs, which is not what the plugin ships. Removed the claim that read-only tools work without auth and described the OAuth-on-install flow (matches authentication: ON_INSTALL in marketplace.json).
  • CHANGELOG: 1.1.0 entry.

Not in this PR (portal-side or other repos)

  • Support URL (https://help.apify.com/en/) goes into the portal form; supportURL is not a valid manifest field.
  • Domain verification token at /.well-known/openai-apps-challenge, demo reviewer account, CSP for widget tools, 5+3 test cases, release notes.
  • Consider per-tool auth in apify-mcp-server so search/docs work before sign-in (follow-up).

Validation

uv run --with pyyaml python validate_plugin.py apify
Plugin validation passed

🤖 Generated with Claude Code

- Wrap .mcp.json in mcpServers (validator requirement)
- Add interface.defaultPrompt starter prompts
- Shorten shortDescription to 30 chars
- Bump version to 1.1.0 to match CHANGELOG
- README: all tools require authentication with the default tool set

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

@Jakub-Vacek Jakub-Vacek left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks fine.
It might be a good idea to to retest if the MCP still works after merge - change of mcp config can be breaking

@vystrcild
vystrcild merged commit e1e200d into main Sep 8, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants